跳到主要内容

打包 iOS app

egret-ios-support是Egret打包为原生ios APP的方案，你可以使用egret-ios-support将你的HTML5游戏打包为ipa文件，并提供给用户安装。

具体使用方法如下：

预备知识​

为了顺利完成本教程，请确认您已熟练掌握以下知识：

  • 了解文件、文件夹的概念，以及创建，移动、复制、重命名和删除等知识。

  • 了解终端、命令行、Shell其中之一，会启动她，并能通过命令行执行的方式完成上一条的相关操作

  • 了解如何下载文件并解压缩文件

  • 了解以下术语：

    • 编写游戏逻辑需要：JavaScript、TypeScript、nodejs、npm
    • 打包iOS App需要：Objective-C、C++、Xcode

文档概述​

本文会完整的展示如何在一个已经安装npm管理包的环境中全新安装Egret核心包、Egret的iOS支持包，最终在模拟机中运行Demo的过程。

本文分为三部分：第一部分为iOS开发环境的安装、第二部分为Egret游戏框架的安装、第三部分创建一个完整iOS App的示例。

iOS开发环境安装​

安装iOS开发环境——Xcode​

运行App Store，在搜索项查找“Xcode”，下载并安装即可

安装Egret游戏框架​

预备知识​

运行Mac OS X的Terimal应用：在Finder中打开Applications文件夹，再打开Utilities文件夹，找到Termial应用，双击运行。如下图：

进入你的工作目录，在演示中，我们的的工作目录为“labs/”，工作目录为空文件夹，如下图：

接下来，为我们的游戏建立一个projects文件夹，运行


$ mkdir projects


如下图：

下载Egret的iOS支持包​

创建Egret Support文件夹

下载Egret ios支持包

下载egret-ios-support，将egret-ios-support放置在“labs/egret-support/”文件夹下，如下图：

创建一个iOS打包的示例​

创建一个Egret项目​

这里创建一个名称为ACoolHtmlGame的项目，使用命令如下：


$ egret create ACoolHtmlGame


如图：

编写你的游戏项目​

接下来要做的事情就是编写你的游戏项目逻辑。这里我们不进行操作，使用默认的项目来进行演示。

创建你的ios项目工程​

从你的HTML5游戏创建ios项目工程​

回到我们的游戏工程文件夹“labs/projects/”下，我们通过一个新的命令来创建适用于ios的项目，该命令创建项目时，需要指定原有HTML5工程和你的egret-ios-support路径。命令如下：

$ cd projects/

$ egret create_app ACoolIosGame -f ACoolHtmlGame -t ../egret-support/egret-ios-support


create_app命令可用来创建适用于ios的项目工程。ACoolIosGame则是该工程的工程名。

-f参数则指定我们的HTML5游戏项目，我们直接将刚刚创建的HTML5项目路径填写进入即可。

-t参数则是ios项目工程的模板，我们需要指定“egret-ios-support”项目路径。

下图为运行命令演示：

运行命令后，你将看到新生成的ACooliosGame项目文件夹，该文件夹结构如下：

自此，我们已经创建了一个完整的ios工程，我们来看一下当前的文件层级：


labs/-+

 +-- egret-core/-+                         # egret

 +-- egret-support/-+                      # egret 支持库

 |                  +-- egret-ios-support/ # ios支持

 +-- projects/-+

 |             +-- ACoolIosGame            # ios工程

 |             +-- ACoolHtmlGame           # html应用

 ...


编译iOS游戏​

导入项目​

打开ACoolIosGame文件夹，双击“ACoolIosGame.xcodeproj”，等待Xcode加载完成

测试项目​

点击Xcode的Run命令，直接进入iOS模拟器运行

下图为运行效果

如需生成ipa包，请访问苹果开发网站，注册开发者账号，阅读相关设置即可。

自此，完成了使用Egret实现一个iOS游戏应用的全过程。

项目开发的整体流程​

我们推荐的开发方式：在原有的HTML5游戏项目中进行开发，开发测试ok，再编译到iOS平台。下面为大家演示一下流程：

1、创建一个HTML5游戏：

egret create ACoolHtmlGame

2、创建对应的iOS游戏

egret create_app ACoolIosGame -f ACoolHtmlGame -t ../egret-support/egret-ios-support

3、测试一下各个平台游戏

4、在ACoolHtmlGame中开发游戏，一个小步进的开发后，我们要开始编译我们的游戏并在浏览器上测试，这是使用

egret build ACoolHtmlGame --runtime native -e

这行命令执行了两项任务：1.编译TypeScript到JavaScript，2.将编译出的文件同步到Xcode项目中。这里需要注意的有两点：1.编译的项目是HTML5项目，2.不要更改iOS项目的位置，项目位置的设置将在高级教程给出, 3.此时HTML5项目会失效，想查看HTML5项目，请使用

egret build ACoolHtmlGame -e

来使得HTML5项目生效，此时iOS项目失效。

5、此时可以使用egret startserver ACoolHtmlGame 启动游戏服务，这样浏览器就能观察到实现的游戏逻辑了。

6、接下来回到ACoolIosGame的Xcode工程中，使用Xcode来清除、重新编译、调试项目，这样就可以在手机上得到和HTML项目的游戏逻辑了。

7、返回4，不断的迭代。